home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / xfer150.arc / XFER.DOC next >
Text File  |  1986-08-15  |  10KB  |  230 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.               <<<===  X F E R - DOS FILE TRANSFER UTILITY  ===>>>
  11.  
  12.                          Version 1.50, August 15, 1986
  13.  
  14.                      (C) 1985, 1986 J.C. Kilday Associates
  15.  
  16.  
  17.  
  18.                      Developed at the Northern Lights BBS
  19.  
  20.                            207-766-2467    2400/1200
  21.  
  22.  
  23.  
  24.  
  25.                                Table of Contents
  26.                                -----------------
  27.  
  28.                      Introduction ....................  1
  29.  
  30.                      Description .....................  1
  31.  
  32.                      Operating XFER ..................  2
  33.  
  34.                      New Features of v1.50 ...........  3
  35.  
  36.                      Distribution and Restrictions ...  3
  37.  
  38.                      Support .........................  4
  39.  
  40.  
  41.                                   XFER v1.50                         Page 1
  42.  
  43.  
  44.      Introduction
  45.      ------------
  46.  
  47.      XFER  is  a  standalone  communications  utility  supporting   XMODEM,
  48.      XMODEM/CRC, and YMODEM file transfer operations at the DOS level on  a
  49.      host PC.  It is installed on a host system and may be invoked during a
  50.      communications session  by a  caller after  being granted  host system
  51.      access at the DOS level (CTTY COM1 or CTTY COM2 invoked).
  52.  
  53.      This package is intended for use by BBS sysops or others who have need
  54.      for operating a "host  system" remotely and performing  configuration,
  55.      maintenance, or file  updating/replacement functions.  It  facilitates
  56.      file transfers directly to/from  directories which are not  accessible
  57.      while using the host communications software, such as a BBS. XFER also
  58.      may be used with simpler  host software packages which allow  a caller
  59.      to drop to DOS (e.g.,  JaxHost v3.0, a shareware product  available on
  60.      many  BBS's  as  JAXHOST3.ARC).   XFER  will  not  work in local mode,
  61.      outside of a communications environment.
  62.  
  63.      XFER  is  designed  for  operation  on  an  IBM PC, XT, AT, or a close
  64.      compatible, with up to 2 communications ports (known as COM1 and COM2)
  65.      operating at 300, 1200, or 2400 bps.
  66.  
  67.  
  68.      Description
  69.      -----------
  70.  
  71.      On start-up, XFER searches  for an "active" communications  port (COM1
  72.      or COM2).  If the status of COM1, is DATA SET READY and CARRIER DETECT
  73.      and  a  speed  of  300,  1200,  or  2400  bps,  then  XFER  takes over
  74.      communications at N, 8, and 1.   If COM1 is not active, it  checks for
  75.      an active COM2 meeting the  same criteria.  If neither port  is active
  76.      (meaning it  was started  while in  local mode  and no  communications
  77.      active), XFER exits after printing on the would-be "host" console  "NO
  78.      COMM PORT ACTIVE."
  79.  
  80.      XFER may be  invoked in command-line  mode or in  normal (menu-driven)
  81.      mode.  The next section describes the syntax for invoking XFER.
  82.  
  83.      Three file transfer protocols are supported as listed in the  previous
  84.      section.  The Ymodem implementation in XFER is noticeably faster  than
  85.      that provided in many  communications programs when operating  at 2400
  86.      bps.  The Ymodem "receive" (upload to the host) is 7%, or more, faster
  87.      than that of popular BBS software packages when running at 2400 bps on
  88.      4.77 Mhz. CPU's -- PC's or XT's.  Although not supporting batch Ymodem
  89.      transfers,  the  Ymodem  implementation  in  XFER  is  compatible with
  90.      software  which  sends  a  "Ymodem  block  0"  or which shifts down to
  91.      Xmodem/CRC-sized blocks at some point during the Ymodem tranfer.
  92.  
  93.      
  94.                                   XFER v1.50                         Page 2
  95.  
  96.  
  97.  
  98.      Operating XFER
  99.      --------------
  100.  
  101.      File transfer occurs to/from the default directory on the host  system
  102.      or the drive/directory included in  the filespec entered for the  file
  103.      to  be  uploaded/downloaded.   XFER.EXE  should  be  located  in   any
  104.      directory included in  the current PATH  on the host  system.
  105.  
  106.      Command syntax for the menu-driven mode is simply:
  107.  
  108.                                    XFER [Y]
  109.  
  110.      Ignore the square brackets ( [, ] ).   The optional parm ("Y"  or "y")
  111.      specifies  that  XFER  is  to  be  initialized  for  conducting YMODEM
  112.      transfers only.   If the  Y parm  is omitted,  XFER is  initialized to
  113.      conduct XMODEM (Checksum or CRC) transfers only.
  114.  
  115.      If  XFER  is  started  without  the  Y  parm, downloads use the XMODEM
  116.      variation the remote system  is set for.  XFER  adjusts automatically.
  117.      XMODEM/CRC  uploads,  however,  are  specified  by  entering  "U"; and
  118.      Checksum uploads by "C" as shown by the XFER menu.  Any combination of
  119.      uploads and downloads may be performed before quitting to DOS.  Return
  120.      to DOS is accomplished without loss of carrier.
  121.  
  122.      Command syntax for the command-line mode is:
  123.  
  124.                           XFER U|D filespec [X|C|Y]
  125.  
  126.      You  must  specify  a  U  or  a  D  after  the command if invoking the
  127.      command-line mode; where U indicates an upload to the host system  amd
  128.      D indicates download from the  host system.  Filespec is the  full DOS
  129.      pathname and filename referring to the destination and name of a  file
  130.      to be uploaded or  the source and name  of the file to  be downloaded.
  131.      The  optional  parameters  X,  C,  and  Y  specify the protocol to use
  132.      (Xmodem,  Xmodem/CRC,  and  Ymodem,  respectively.   If  none of these
  133.      characters is specified  after the filespec,  the default protocol  of
  134.      Xmodem (checksum) is used.
  135.  
  136.      Examples:
  137.  
  138.      XFER                              - Invokes menu-driven/Xmodem mode
  139.  
  140.      XFER Y                            - Invokes menu-driven/Ymodem mode
  141.  
  142.      XFER d d:\comm\JaxHost3.arc y     - Invokes command-line mode to
  143.                                          download a file from the given
  144.                                          drive/directory using Ymodem
  145.  
  146.      XFER U TEST.TXT                   - Invokes command-line mode to
  147.                                          upload a file to the current
  148.                                          (default) directory using the
  149.                                          default protocol - Xmodem
  150.      
  151.                                   XFER v1.50                         Page 3
  152.  
  153.  
  154.      Operating XFER (Continued)
  155.      --------------------------
  156.  
  157.      Please  note  that  entry  of  invalid  path  names and file names may
  158.      produce various  error reports  of the  nature, "Error  xx occurred in
  159.      line yyy of ... ."  Every attempt has been made to trap all such error
  160.      conditions so that the program will terminate gracefully.
  161.  
  162.  
  163.  
  164.      New Features of v1.50
  165.      ---------------------
  166.  
  167.      The previous public version of XFER was 1.41.  Version 1.50 provides
  168.      the following enhancements/new features:
  169.  
  170.      - The Ymodem implementation now supports receipt of a "block 0" which
  171.        may be sent as the first block of a Ymodem upload by some programs.
  172.        No processing of this block is performed (it is discarded).
  173.  
  174.      - The Ymodem implementation now supports the "step down" to 128-byte
  175.        blocks (actually 133 transmitted bytes per block) that may occur
  176.        during an upload, depending on the comm program used.
  177.  
  178.      - A command-line option of invoking/operating XFER is available.  For
  179.        example you may describe an upload using Ymodem to the host system
  180.        as:   xfer u c:\work\foo.bar y    and bypass the menu.
  181.  
  182.      - And last but not least, ... this software has left the ranks of
  183.        "completely free" and public domain software products.
  184.  
  185.      Distribution and Restrictions
  186.      -----------------------------
  187.  
  188.      XFER v1.50 is made available to you for private, personal use.  If you
  189.      find that  you have  continued use  for it  and would  like to  see it
  190.      supported and enhanced, a contribution of $10 would be appreciated and
  191.      it would help with the growth of the Northern Lights BBS.
  192.  
  193.      You are welcome to distribute this package to others so long as it  is
  194.      unmodified and distributed in its entirety, and it is not included  or
  195.      bundled  with  other  goods  or  services  for which a fee is charged.
  196.      Exceptions are  that XFER  may be  distributed by  bulletin boards  or
  197.      other information  services even  though they  receive fees  to access
  198.      their downloadable files,  or by library  services so long  as the fee
  199.      for the diskette on which this  package is contained is not more  than
  200.      $6.50.
  201.  
  202.      Use  of  XFER  by  business  entities,  corporations,  and  government
  203.      agencies is  prohibited without  payment of  a license  fee of $15 per
  204.      installed copy (site licenses available).
  205.      
  206.                                   XFER v1.50                         Page 4
  207.  
  208.  
  209.  
  210.      Support
  211.      -------
  212.  
  213.      Support is  available to  private users  who have  contributed to  the
  214.      well-being of the Northern Lights BBS  and to business users  who have
  215.      paid the appropriate license fees.  This support is primarily  offered
  216.      through  the  message  base  of  the  Northern Lights BBS which can be
  217.      reached  at  the  number  given  below  and  on the cover page of this
  218.      documentation.  Please note that support  is provided only for use  of
  219.      XFER on equipment for which it was designed (described earlier).
  220.  
  221.      Contributions and license fees may be made payable to:
  222.  
  223.               J.C. Kilday Associates
  224.               Central Ave.
  225.               Peaks Island, ME 04108
  226.  
  227.      The author, Jack Kilday, may  be contacted at that address  or through
  228.      the Northern Lights BBS (address messages to "Sysop") at  207-766-2467
  229.      (calls accepted at 2400 and 1200 bps and N, 8, 1).
  230.